home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #258 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #258 (1993)(Rhein-Sieg-Soft).adf / ILBM-Packer1,0.doc < prev    next >
Text File  |  1993-08-06  |  8KB  |  167 lines
  1.  
  2. ILBM-Packer V1.0 (c) by Alexander Wegner June 17.August.93
  3.  
  4. Introduction
  5. ------------
  6. This program is shareware. It may be distributed freely, if you follow
  7. these three rules:
  8. 1. The executable must be distributed with this .doc file, and the german
  9. .dok file.
  10. 2. All files must be unmodified.
  11. 3. Copies should not be sold. A fee for disks and copying which may not be
  12. higher than 6 US$ is allowed.
  13.  
  14. If you use this program please send a shareware fee of 5 US$ or 8 DM.
  15. Everyone who pays this shareware fee will be informed when a new version
  16. is ready. If you send 10 US$ or 16 DM (12 US$ for oversea) I'll send you a
  17. new version on disk when it's ready.
  18. Please make payments in US$ only with banknotes. If you pay in DM you can
  19. (must) use coins.
  20. If you want to use this program in commercial products please ask me for
  21. permission.
  22. Send money, remarks, bug reports to the adress below.
  23.  
  24.  
  25. **************************************************************************
  26. * Please note: The author is not responsable for any damages caused by   *
  27. * this program.                                                          *
  28. **************************************************************************
  29.  
  30.  
  31. What is ILBM-Packer
  32. -------------------
  33. One of the advantages of our favourite machine is the IFF/ILBM (Interchange
  34. File Format / InterLeaved BitMap) format which is used by nearly every graphic-
  35. program. But everybody knows that computer-graphics need a lot of disc-space,
  36. expecially if you use the HAM (Hold And Modify) mode.
  37. Its also difficult to compress ILBM-files with an ordinary file packer. There
  38. are two reasons for this fact:
  39. 1. Most of the ILBM- files are compressed with the byterun1 algorithm,
  40. which is a part of the ILBM standart and is used by many graphic-tools.
  41. This algorithm works quite fast, but it's only effective if there are
  42. bigger areas in the same color in your picture. 
  43. 2. Pics that are created with a ray-tracer or which are video-digitized and/or
  44. dithered are quite "chaotic", because there usually aren't bigger areas in the
  45. same color or pattern.
  46.  
  47. ILBM-Packer is a file packer which is specialized in ILBM-Files. You cannot
  48. use it on any other files. ILBM-Packer uses an algorithm which reads the
  49. bitmap-header and considers the graphic-mode (size, num. colors...).
  50. Therefore it's more effective than ordinary packers.
  51. The program is written in assembler which makes it working quite fast.
  52.  
  53. How to use ILBM-Packer
  54. ----------------------
  55. The usage of this tool is quite simple. The best way is to copy it into
  56. your c directory, because it's used from the shell or cli. You have to type
  57. the following: ILBMP <sourcefile> <targetfile> . The sourcefile will be
  58. loaded, crunched and saved under the name and path specified as targetfile. 
  59. If (for example) your currend dir is "df0:diashow" and you type:
  60. ILBMP monalisa.pic dh0:pics/monalisa.cbm 
  61. A file called monalisa.pic is loaded from the drawer df0:diashow and saved
  62. as a crunched file under the name "monalisa.cbm" in the dir dh0:pics. It's
  63. advised to use extensions like ".cbm (crunched bit map) or what ever you
  64. want, because it's easyer to see whether a file is compressed or not.
  65. ILBM-Packer will open a window to display informations. You will see the
  66. name of the sourcefile, its lenght in bytes, x and y size of the graphic,
  67. the number of bitplanes and the actual compression of the sourcefile. The
  68. value after "compress." can be "none" or "byterun1" that will mean, that
  69. the file is uncompressed or the byterun1 algorithm is used. After the
  70. sourcefile is loaded and byterun1 is decrunched (if needed) the file will
  71. be compressed in two passes. If the compression was succesful the lenght of
  72. the new file will be displayed in bytes and in percent and the new file
  73. will be saved.
  74. If you want to decrunch a file you have to do the same. The file that
  75. should be decrunched must be specified as sourcefile. The actual
  76. compression is ILBMP. Decrunching starts with Pass 2 (last in first out).
  77.  
  78. If the byterun1 algorithm was used in the original file the decrunched file
  79. will be bigger than the original, because the files are not recrunched with
  80. byterun1 by the packer. To bring the file to its original size, you have to
  81. load and save it whith a graphic-tool that supports byterun1 (D-Paint for
  82. example). 
  83.  
  84. Sourcefile and targetfile can be the same. In this case the sourcefile is
  85. overwritten with the packed one. This can be dangerous, because errors while
  86. owerwriting the file can destroy both (source and targetfile). So make a
  87. copy of the sourcefile before overwriting it.
  88.  
  89. How to use the ILBM-Packer in script-files
  90. ------------------------------------------
  91. This tool hasn't got an internal script-function, but it can be used in
  92. script-files without problems. At this point i've got a special hint for
  93. you: If you have, for example, a dir named "dh0:pics" with 20 ILBM-files
  94. in it, and you want them to be crunched and saved with a ".cbm" extension
  95. in "dh0:archive", you have to type the following into your CLI-window:
  96. 'list dh0:pics lformat="ilbmp %s%s dh0:archive/%s.cbm" to ram:script'
  97. This command will create a fit script-file, which can be executed by
  98. typing: 'execute ram:script'.
  99.  
  100. Possible problems and solutions
  101. -------------------------------
  102.  
  103. bad arguments (return code 10):
  104. Bad command line. Sourefile and targetfile were not specified properly.
  105.  
  106. not an ILBM-file (return code 10):
  107. The sourcefile has not been recognized as an ILBM-file. Check the filename!
  108.  
  109. file not found (return code 10):
  110. ILBM-Packer couldn't open your sourcefile. Check path and currend dir!
  111.  
  112. out of memory (return code 20):
  113. Not enough or fragmented memory. Reboot your machine (to avoid
  114. fragmentation), remove disk buffers, clear RAM: and RAD:, close all other
  115. tasks and try again.
  116.  
  117. file has not been compressed (return code 5):
  118. I hope you'll not see this very often. This can happen if your file is very
  119. chaotic or has less than 3 bitplanes (less than 8 colours). The algorithm
  120. does not work very good on files with 1 or 2 bitplanes.
  121.  
  122. disk error while writing targetfile (return code 20):
  123. This could be "read write error" or "disk is full" or any other reason, why
  124. the targetfile has not been written properly if you had a "disk is full"
  125. requester you must delete the targetfile, because it's truncated. 
  126.  
  127. software error guru meditation... (return code ?)
  128. There are many reasons for that. One of them could be a truncated
  129. sourcefile. Be sure, that your sourcefiles are okay.
  130.  
  131.  
  132.  
  133. Compatibility
  134. -------------
  135. ILBM-Packer has been tested on the following hardware: A2000 rev4; rev6;
  136. kick 1.3 and 2.0 (both on roms); RLL and SCSI harddisks; 68030 turboboard
  137.  
  138. Incompatibility
  139. ---------------
  140. ILBMP does not work correctly with the stencil function of DPaint. There
  141. may be problems with other "special functions" like that. 
  142.  
  143. ILBM-Packer and the new graphicmodes
  144. ------------------------------------
  145. I don't know if ILBMP is compatible to the new A1200 A4000 graphicmodes,
  146. because I didn't have the chance to test it on such a machine
  147.  
  148.  
  149. My adress
  150. ---------
  151.  
  152.  
  153.   Please send money, comments, bug reports ... to:
  154.  
  155.  
  156.                              Alexander Wegner
  157.                              Mackensenstraße 5
  158.                              42329 Wuppertal
  159.                              Germany
  160.  
  161.  
  162.               ************************************************
  163.               *     //                                       *
  164.               * \\ // greetings to all users in the world    *
  165.               *  \X/                                         *
  166.               ************************************************
  167.